-
Notifications
You must be signed in to change notification settings - Fork 160
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
docs: replaced the link in the documentation #1970
docs: replaced the link in the documentation #1970
Conversation
Could we hold off on this until the dust settles on this issue? https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/issues/5805 We really need to the documentation to actually be updated when the content is modified here: |
I understand, tell me, should I close this request pool or keep it open? |
If I understand the direction, the existing URI should work and should be redirected to something valid automatically. But we probably would be better to specify that final redirection location instead. But whether that's eclipse.dev/swt or eclipse.dev/eclipse/swt is not yet 100% clear. If you have the patience, leaving this open as a reminder to take action is a good thing. I will add this to my pin tabs list. |
Yes, I understand you, no problem, I will wait for your answer. |
The final redirected location is the following: |
Done |
Sorry, sorry, only now do I read the whole context. 😱 These are instructions for where to get downloads not where to get documentation. That existing page is the index. Unfortunately the documentation is rather helpful because it doesn't explain that one needs to pick a specific version, e.g., https://download.eclipse.org/eclipse/downloads/drops4/S-4.36M1-202504031800/ And then get an SWT zip from the list: |
It's okay, I completely agree with you, please check again. |
Maybe for convenience add #SWT at the end of the link, what do you think?https://download.eclipse.org/eclipse/downloads/drops4/S-4.36M1-202504031800/#SWT |
The problem is that that link will be out-of-date in a few weeks and will be a broken link within 3 months. I really think the documentation must specify a location that remains valid long term. Of course the user then ends up needing to hunt. So better to describe what is on that root download page and describe what’s on the subsequent page. |
Sorry, I'm communicating with you through a translator, there are some translation difficulties. I made a draft, check it out, did I understand everything correctly? SWT постачається з файлами баночок, характерними для платформи. Завантажте їх із https://download.eclipse.org/eclipse/downloads/drops4/S-4.36M1-202504031800/ і додайте файл баночки до свого класного шляху. |
Hey @merks. Please help me solve this question |
The summary is that I don't think can fix this just by changing the URL. You need to describe stuff in English and if that's a challenge this is probably not an appropriate task to take on... |
Review my draft: Getting Started |
I think we have a bit of a language barrier here and I'm not sure that it makes sense to contribute language-specific documentation in the face of such a language barrier... |
yes, I agree with you, I'd better close this pull request then? |
I don’t know how those badges work. Maybe @HannesWell has more knowledge. |
That makes it indeed very difficult. But besides that, @merks is right with his statement that this link will not last long. So we should either describe verbally how to navigate to the desired section or establish some kind of latest redirection link that points to the latest. But I think the former is easier to implement.
OK, then lets close this for now. If you are interested to implement the above suggestion, feel free to let us now so that we can reopen this or create a new PR. |
Thank you for the kind words, I'm sorry I couldn't solve this problem on my own. |
In my opinion, the new link fits here better.